home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 January / PSL Monthly Shareware CD-ROM (Public Software Library) (January 1994).iso / games / dos / misc / snafu2.com / SNAF-DOC.COM (.txt) < prev    next >
Encoding:
Graham's TXT2COM  |  1989-11-23  |  11.3 KB  |  184 lines
  1.  
  2.                               SNAFU,  Version 2.0
  3.                                 November, 1989
  4.                              Freeware by Ken Dowst
  5.  
  6.  
  7.  
  8. WHAT IT DOES:
  9.  
  10.      SNAFU makes an MSDOS computer temporarily respond in a bizarre manner to 
  11. any command entered.  The computer will seem to act wildly inappropriately 
  12. and/or will give odd error messages.  
  13.  
  14.      No damage of any kind is done to the computer or its files.
  15.  
  16.      When a directory listing is requested, SNAFU will print a forgery listing 
  17. both real and phony files.  Listed also will be the actual volume name and a 
  18. mangled version of the actual path.  As a decorative touch, the listing will be 
  19. tastefully sprinkled with smiley-faces and other garbage characters.  (Don't 
  20. neglect to try out, too, the "cd" command.)
  21.                                                                              
  22. (Press <PgDn> to continue. . . . )
  23.  
  24.      After acting out-of-line for five or six commands (not counting DIR, which 
  25. *always* prints a directory listing; and not counting the press of <Enter> 
  26. alone, which always reprints the prompt), the computer will resume normal 
  27. operation.  Sign: look for "Returning to DOS prompt. . . ." followed by a real 
  28. directory listing.  The next DOS prompt after that will be a real one.  If you 
  29. choose, SNAFU will leave behind a "readme" file explaining what had happened.  
  30.  
  31.  
  32. STARTING SNAFU:
  33.      
  34.      SNAFU *does not* clear the screen when it begins.  It erases only the 
  35. command line from which you invoked it.  Any text already on the screen will 
  36. remain there.  (Clever, eh?)  The best way to run SNAFU on a friend's computer 
  37. is to put a floppy containing SNAFU.EXE into an unused drive (let's say A:). 
  38. DON'T change the current drive.  Enter "A:SNAFU" (without the quotes), then 
  39. remove the floppy.  That way you will leave no trace of your shenanigans.  
  40.  
  41.      If the disk in the default drive is write-protected, or if the computer is 
  42. running a memory-resident anti-virus program that prevents disk writes, then 
  43. SNAFU will not run.  If the anti-virus program prevents only writes to hard 
  44. drives and allows writes to floppies, then you can run SNAFU by changing the 
  45. default drive to A: 
  46.  
  47.  
  48. ANSWERING THE INITIAL PROMPTS:
  49.  
  50.      (1) When SNAFU begins, it will print what it thinks is the DOS prompt and 
  51. ask for your approval.  You can then accept the prompt or change it.  If the 
  52. original prompt uses sophisticated ANSI control-code sequences, you may not 
  53. be able to duplicate it exactly.  Fortunately, most computers are set to 
  54. produce  simpler prompts that SNAFU can forge without trouble.
  55.  
  56.      (2) Next SNAFU will ask if you wish to leave behind an explanatory text 
  57. file.  I recommend pressing <Y> (for "Yes") to create the file, but the choice 
  58. is yours.  The text file is given a name both attention-getting and unlikely 
  59. already to exist: -README-.(!).  In the event a file by that name already 
  60. exists, the message is added to the end of it.  The text will reassure the user 
  61. that no harm was done to the computer or its files and advises the him to make 
  62. backup copies of his files regularly--for computers DO run amok on their own 
  63. from time to time.  (Backed up your own hard disk lately?) 
  64.  
  65.      (3) Then SNAFU will ask about the type of monitor in use.  Press <M> if
  66. monochrome or <C> if color (even if the color monitor is displaying black-on-
  67. white or another monochrome-like combination of colors).  Some of the 
  68. computer's behavior can be *very* colorful under SNAFU.
  69.  
  70.      (4) Many systems with color monitors use memory-resident programs to set 
  71. the default screen colors.  Version 2.0 of SNAFU allows you to reproduce these 
  72. default colors; however, you must select the appropriate colors manually.  If 
  73. you indicate a color monitor, SNAFU will then prompt you three times to select 
  74. the appropriate color of letters, of background, and of border, respectively.  
  75. (If you do not see a border around the edges of the screen, then the border is 
  76. the same color as the background.)  In each case, when prompted enter the 
  77. color's *number*, not its name.  SANFU uses the standard color-numbering system 
  78. of BASIC, which is: 
  79.  
  80.    0 = black       4 = red         8 = grey           12 = light red (pink)
  81.    1 = blue        5 = magenta     9 = light blue     13 = light magenta
  82.    2 = green       6 = brown      10 = light green    14 = yellow
  83.    3 = cyan        7 = white      11 = light cyan     15 = bright white
  84.  
  85.      If, instead of entering a number, you just press <Enter>, SNAFU will 
  86. display a chart of the colors and their numbers and then prompt you again to 
  87. enter the number.  If you make a mistake in entering the color numbers, don't 
  88. worry: you'll soon be able to abort the program and start again.
  89.  
  90.      If you indicated a monochrome monitor in step (3), SNAFU will skip the 
  91. color prompts.  
  92.  
  93.      (5) Finally, SNAFU will give you 6 seconds to abort the program by 
  94. pressing <Esc>.  Do so if you've made a mistake in specifying the DOS prompt or 
  95. the screen colors.  If <Esc> is not pressed, SNAFU will then begin imitating 
  96. the operating system.  Once it does so, you cannot break out of the program 
  97. except by running through it to its end or by turning off the computer's power:
  98. for maximum fun, SNAFU disables the Ctrl key, preventing aborting with <Ctrl-
  99. Break> and <Ctrl-Alt-Del>.
  100.  
  101.  
  102. HOW THE PRGRAM WORKS:
  103.  
  104.      SNAFU is completely harmless.  It is not memory-resident.  While the user 
  105. *thinks* he is seeing the DOS prompt, he is (for a while, at least) seeing a 
  106. forgery printed by SNAFU.  For added realism, the program accesses the disk 
  107. from time to time.  
  108.  
  109.      What actually happens during disk accesses is this: a file with an 
  110. improbable name is created and then erased.  At the very beginning of the 
  111. program two temporary files are also created, used by the program, and then 
  112. erased.  These files enable SNAFU to find the DOS prompt and some real 
  113. filenames to put in the phony directory listings.  No damage of any kind is 
  114. done to any of the user's files or to any other part of the computer.  No 
  115. Trojan, virus, worm, or other nasty critter is left behind--only (optionally) a 
  116. note explaining what happened.  
  117.  
  118.      
  119. ETYMOLOGY:
  120.      
  121.      The word "SNAFU" is an acronym popular, especially among soldiers, during 
  122. World War II.  It stands for "Situation Normal: All F***ed Up"  ("Fouled" 
  123. became the standard euphemism for the key term.)  The word's cousin is of 
  124. course "FUBAR," the last 60% of which stands for "Beyond All Recognition."  For 
  125. some reason, both terms are popular among computer programmers and systems
  126. analysts today.  Don't ask me why.  
  127.  
  128.  
  129. DISTRIBUTION AND FEEDBACK:
  130.  
  131.      SNAFU is free.  You may distribute copies at will, so long as you do not 
  132. charge for the program without my permission.  (A modest charge for media, 
  133. connect time, postage, handling, and so forth is not prohibited.)  If you like 
  134. SNAFU--or even if you don't--I ask only three things (and one of them requires 
  135. *no* effort): 
  136.  
  137.                (1) Please pass around copies to friends and upload copies
  138.                      to some bulletin boards.  (IMPORTANT: Please be sure
  139.                      SNAF-DOC.COM accompanies SNAFU.EXE)
  140.  
  141.                (2) Please do not make any changes to the program or its
  142.                      documentation.
  143.                
  144.                (3) Drop me a note if you conveniently can.  You can reach me
  145.                      on CompuServe--in the forums IBMNEW and IBMPRO, or via 
  146.                      Easyplex--at 71257,252.  You can reach me on PARTICIPATE 
  147.                      on CompuServe at "KEN DOWST".  Or if you'd prefer, try a 
  148.                      Hartford-area BBS (perhaps Windsor Manor: 203-688-4973).
  149.      
  150.  
  151. If you yourself are a programmer, please consider contributing some of your 
  152. work to the public domain.  
  153.  
  154.  
  155.                                -- = < * > = --
  156.  
  157. SNAFU is written and compiled with Microsoft QuickBASIC 4.5.  It runs on IBM-
  158. PC-compatible computers with color or monochrome displays.  
  159.  
  160. Version 1.2 improved the DOS-prompt-finding routine of 1.1; thanks to Ty 
  161. Halderman for help with this.  Version 1.3 improved the last two error-messages 
  162. and replaced the .DOC text file with SNAF-DOC.COM.  Version 2.0 improves the 
  163. error-messages further and adds color handling.  Coincidentally (honest!), the 
  164. release date is the 26th anniversary of the beginning of one of the larger 
  165. SNAFU's of American history, one a good deal less amusing than the present 
  166. program.  
  167.  
  168.                                         Ken Dowst
  169.                                         Hartford, Connecticut
  170.                                         November 22, 1989
  171.  
  172.  
  173.                                -- = < * > = --
  174.  
  175. Program and text are copyright (C) 1989 by Ken Dowst.
  176.  
  177. (Press <Esc> to quit. . . .)
  178.  
  179.  
  180. 
  181.  
  182.  
  183.  
  184.